home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 April / Software of the Month Club 1996 April.iso / pc / os2 / psutils / man / pstops.doc < prev   
Text File  |  1996-02-21  |  5KB  |  199 lines
  1.  
  2.  
  3.  
  4. PSTOPS(1)                                               PSTOPS(1)
  5.  
  6.  
  7. NAME
  8.        pstops - shuffle pages in a PostScript file
  9.  
  10. SYNOPSIS
  11.        pstops  [ -q ] [ -b ] [ -wwidth ] [ -hheight ] [ -ppaper ]
  12.        [ -dlwidth ] pagespecs [ infile [ outfile ] ]
  13.  
  14. DESCRIPTION
  15.        Pstops rearranges pages from a PostScript document, creat-
  16.        ing  a  new  PostScript  file.   The input PostScript file
  17.        should follow the Adobe Document Structuring  Conventions.
  18.        Pstops  can be used to perform a large number of arbitrary
  19.        re-arrangements  of  Documents,  including  arranging  for
  20.        printing  2-up, 4-up, booklets, reversing, selecting front
  21.        or back sides of documents, scaling, etc.
  22.  
  23.        pagespecs follow the syntax:
  24.  
  25.               pagespecs   = [modulo:]specs
  26.  
  27.               specs       = spec[+specs][,specs]
  28.  
  29.               spec        =
  30.                           [-]pageno[L][R][U][@scale][(xoff,yoff)]
  31.  
  32.        modulo is the number of pages in each block. The value  of
  33.        modulo  should  be greater than 0; the default value is 1.
  34.        specs are the page specifications for the  pages  in  each
  35.        block.  The  value  of  the  pageno in each spec should be
  36.        between 0 (for the first page in the block)  and  modulo-1
  37.        (for the last page in each block) inclusive.  The optional
  38.        dimensions xoff and yoff shift the page by  the  specified
  39.        amount.  xoff and yoff are in PostScript's points, but may
  40.        be followed by the units cm or in to convert  to  centime-
  41.        tres  or inches, or the flag w or h to specify as a multi-
  42.        ple of the width or height.  The optional parameters L, R,
  43.        and  U  rotate  the page left, right, or upside-down.  The
  44.        optional scale parameter scales the page by  the  fraction
  45.        specified.   If  the optional minus sign is specified, the
  46.        page is relative to the end of the  document,  instead  of
  47.        the start.
  48.  
  49.        If  page specs are separated by + the pages will be merged
  50.        into one page; if they are separated by  they will  be  on
  51.        separate  pages.  If there is only one page specification,
  52.        with pageno zero, the pageno may be omitted.
  53.  
  54.        The shift, rotation, and scaling  are  performed  in  that
  55.        order regardless of which order they appear on the command
  56.        line.
  57.  
  58.        The -w option gives the width  which  is  used  by  the  w
  59.        dimension  specifier,  and  the -h option gives the height
  60.        which  is  used  by  the  h  dimension  specifier.   These
  61.  
  62.  
  63.  
  64.                  PSUtils Release 1 Patchlevel 16                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PSTOPS(1)                                               PSTOPS(1)
  71.  
  72.  
  73.        dimensions  are also used (after scaling) to set the clip-
  74.        ping path for each page.  The -p option can be used as  an
  75.        alternative, to set the paper size to a3, a4, a5, b5, let-
  76.        ter, legal, tabloid, statement, executive,  folio,  quarto
  77.        or 10x14.  The default paper size is letter.
  78.  
  79.        The   -b   option  prevents  any  bind  operators  in  the
  80.        PostScript prolog from binding.  This  may  be  needed  in
  81.        cases  where  complex multi-page re-arrangements are being
  82.        done.
  83.  
  84.        The -d option draws a line around the border of each page,
  85.        of  the specified width.  If the lwidth parameter is omit-
  86.        ted, a default  linewidth  of  1  point  is  assumed.  The
  87.        linewidth  is  relative  to  the original page dimensions,
  88.        i.e. it is scaled up or down with the rest of the page.
  89.  
  90.        Pstops normally prints the page numbers of the  pages  re-
  91.        arranged; the -q option suppresses this.
  92.  
  93. EXAMPLES
  94.        This  section contains some sample re-arrangements. To put
  95.        two pages on one sheet (of A4 paper), the pagespec to  use
  96.        is:
  97.  
  98.                   2:0L@.7(21cm,0)+1L@.7(21cm,14.85cm)
  99.  
  100.        To select all of the odd pages in reverse order, use:
  101.  
  102.                                   2:-0
  103.  
  104.        To re-arrange pages for printing 2-up booklets, use
  105.  
  106.                   4:-3L@.7(21cm,0)+0L@.7(21cm,14.85cm)
  107.  
  108.        for the front sides, and
  109.  
  110.                   4:1L@.7(21cm,0)+-2L@.7(21cm,14.85cm)
  111.  
  112.        for  the  reverse  sides  (or  join  them with a comma for
  113.        duplex printing).
  114.  
  115. AUTHOR
  116.        Copyright (C) Angus J. C. Duggan 1991-1995
  117.  
  118. SEE ALSO
  119.        psbook(1), psselect(1), pstops(1),  epsffit(1),  psnup(1),
  120.        psresize(1), psmerge(1), fixscribeps(1), getafm(1), fixdl-
  121.        srps(1),  fixfmps(1),  fixmacps(1),  fixpsditps(1),  fixp-
  122.        spps(1),  fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1),
  123.        extractres(1), includeres(1)
  124.  
  125. TRADEMARKS
  126.        PostScript is a trademark of Adobe Systems Incorporated.
  127.  
  128.  
  129.  
  130.                  PSUtils Release 1 Patchlevel 16                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PSTOPS(1)                                               PSTOPS(1)
  137.  
  138.  
  139. BUGS
  140.        Pstops does not accept all DSC comments.
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                  PSUtils Release 1 Patchlevel 16                3
  197.  
  198.  
  199.